home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / C / Code Resources / Progress CDEF 1.0.2 / Progress README < prev    next >
Encoding:
Text File  |  1994-03-20  |  2.3 KB  |  62 lines  |  [TEXT/ttxt]
  1. Progress CDEF version 1.0.2
  2. ===========================
  3. by Paul Celestin
  4. 20 March 1994
  5.  
  6. Copyright © 1994 by Celestin Company
  7. All Rights Reserved
  8.  
  9. Progress is a CDEF (control definition) that allows you to display a thermometer progress bar, similar to the one the Finder uses when it shows you a file copy in progress. You can use it just about anywhere. I've tested it on various machines and it seems to work fine.
  10.  
  11. VERSION HISTORY
  12. ---------------
  13. 1.0.2 - added ability to set color of thermometer
  14.  
  15. 1.0.1 - bug fixes
  16.  
  17. 1.0.0 - initial release
  18.  
  19. INSTRUCTIONS
  20. ------------
  21. To use the CDEF, create a CNTL with the following settings:
  22.  
  23. The BoundsRect should correspond to where you want the progress thermometer to be displayed in your dialog. Usually, a thermometer is wide and short.
  24.  
  25. Value is the starting value of the thermometer. This is usually set in your program.
  26.  
  27. Visible should be set to true.
  28.  
  29. Max and Min should be set to number like 100 and 0 respectively.
  30.  
  31. ProcID should be set to (CDEF ID * 16) + Variation. I've set the CDEF ID to 37, so in most cases, the ProcID should be set to 576. There are no additional variations available.
  32.  
  33. RefCon should be set to the color you want for the thermometer. To make life easy, the CDEF only supports the old-style colors:
  34.  
  35. 1 - red
  36. 2 - green
  37. 3 - blue
  38. 4 - cyan
  39. 5 - magenta
  40. 6 - yellow
  41. 7 - white
  42.  
  43. Any other number will set the color of the thermometer to black.
  44.  
  45. Titles are ignored.
  46.  
  47. LEGALESE
  48. --------
  49. Progress CDEF version 1.0.2 is Copyright © 1994 by Paul Celestin. All Rights Reserved. It may be freely distributed and used in any public domain, freeware, shareware, or commercial product. It also may be included in any collection including CD-ROM compilations. However, it must include this README, unaltered. I would appreciate a copy of any product in which it is included. Credit would also be nice, though I don't require it. Celestin Company makes no warranty of any kind as to the fitness of this CDEF. Use it at your own risk.
  50.  
  51. Source code is available. Please email me for details. Bugs, gripes, comments, etc. should be sent to me (Paul Celestin) at one of the following addresses:
  52.  
  53. Internet (preferred): celestin@pt.olympus.net
  54. AOL: Celestin
  55. CompuServe: 71630,650
  56.  
  57. Snail mail:
  58.  
  59. Paul Celestin
  60. Celestin Company
  61. 1152 Hastings Avenue
  62. Port Townsend, WA  98368